.TH std::bind1st,std::bind2nd 3 "2024.06.10" "http://cppreference.com" "C++ Standard Libary"
.SH NAME
std::bind1st,std::bind2nd \- std::bind1st,std::bind2nd

.SH Synopsis
   Defined in header <functional>
   template< class F, class T >                         \fB(1)\fP (deprecated in C++11)
   std::binder1st<F> bind1st( const F& f, const T& x );     (removed in C++17)
   template< class F, class T >                         \fB(2)\fP (deprecated in C++11)
   std::binder2nd<F> bind2nd( const F& f, const T& x );     (removed in C++17)

   Binds a given argument x to a first or second parameter of the given binary function
   object f. That is, stores x within the resulting wrapper, which, if called, passes x
   as the first or the second parameter of f.

   1) Binds the first argument of f to x. Effectively calls std::binder1st<F>(f,
   typename F::first_argument_type(x)).
   2) Binds the second argument of f to x. Effectively calls std::binder2nd<F>(f,
   typename F::second_argument_type(x)).

.SH Parameters

   f - pointer to a function to bind an argument to
   x - argument to bind to f

.SH Return value

   A function object wrapping f and x.

.SH Exceptions

   May throw implementation-defined exceptions.

.SH Example


// Run this code

 #include <algorithm>
 #include <cmath>
 #include <cstddef>
 #include <functional>
 #include <iomanip>
 #include <iostream>
 #include <vector>

 int main()
 {
     std::vector<double> a = {0, 30, 45, 60, 90, 180};
     std::vector<double> r(a.size());
     const double pi = std::acos(-1); // since C++20 use std::numbers::pi

     std::transform(a.begin(), a.end(), r.begin(),
         std::bind1st(std::multiplies<double>(), pi / 180.0));
 //  an equivalent lambda is: [pi](double a) { return a * pi / 180.0; });

     for (std::size_t n = 0; n < a.size(); ++n)
         std::cout << std::setw(3) << a[n] << "° = " << std::fixed << r[n]
                   << " rad\\n" << std::defaultfloat;
 }

.SH Output:

   0° = 0.000000 rad
  30° = 0.523599 rad
  45° = 0.785398 rad
  60° = 1.047198 rad
  90° = 1.570796 rad
 180° = 3.141593 rad

.SH See also

   binder1st                        function object holding a binary function and one
   binder2nd                        of its arguments
   (deprecated in C++11)(removed in \fI(class template)\fP
   C++17)
   bind_front                       bind a variable number of arguments, in order, to a
   bind_back                        function object
   (C++20)                          \fI(function template)\fP
   (C++23)
